HOpenRF

HOpenRF
Header:	Files.h		Carbon status:	Supported

Opens the resource fork of file.

OSErr HOpenRF (
    SInt16 vRefNum, 
    SInt32 dirID, 
    ConstStr255Param fileName, 
    SInt8 permission, 
    SInt16 *refNum
);

vRefNum: A volume reference number, a working directory reference number, or 0 for the default volume.
dirID: A directory ID.
fileName: The name of the file.
permission: The access mode under which to open the file.
refNum: On return, a pointer to the file reference number of the opened file.

function result: A result code.

DISCUSSION

Generally, your application should use Resource Manager functions rather than File Manager functions to access a file’s resource fork. The HOpenRF function does not read the resource map into memory and is generally useful only for applications (such as utilities that copy files) that need block-level access to a resource fork. In particular, you should not use the resource fork of a file to hold nonresource data. Many parts of the system software assume that a resource fork always contains resource data.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.